Einheit 3 — Der Werkzeugkasten im Überblick

Was du nach dieser Einheit weißt: Du kennst alle 27 Werkzeuge des 42°flow-MCP-Servers, sortiert nach Aufgabe — und weißt für jede typische Frage, welches Werkzeug sie beantwortet.

Du musst dir diese Liste nicht merken. Claude Code wählt die Werkzeuge selbst. Aber du solltest wissen, was überhaupt möglich ist — sonst fragst du nach Dingen, die nicht gehen, oder machst umständlich von Hand, was ein Werkzeug direkt kann.

Die sechs Gruppen

1. Orientieren — was gibt es?

Werkzeug	Beantwortet
project_list	Welche Projekte habe ich?
workflow_list	Welche Workflows gibt es, in welchem Projekt, aktiv oder deaktiviert?
workflow_show	Wie ist dieser Workflow aufgebaut — Agents, Optionen, Verbindungen?
workflow_export	Gib mir den Workflow als portables JSON

workflow_show ist dein wichtigstes Lesewerkzeug. Es liefert pro Agent die ID, den Typ, alle Optionen und die Quellen/Empfänger — also genau das, was du im Canvas durch Anklicken jedes Agents zusammensuchen müsstest.

2. Nachschlagen — wie geht das?

Werkzeug	Beantwortet
towelscript_catalog	Welche Node-Typen gibt es? (75 Stück)
agent_docs	Welche Optionen kennt dieser Agent, was bedeuten sie, was gibt er aus?
credential_list	Welche Zugangsdaten sind hinterlegt? (nur Namen, nie Werte)
api_spec_list / api_spec_show	Welche OpenAPI-Spezifikationen sind gespeichert?
api_spec_post_agent_config	Baue mir aus diesem API-Endpunkt eine fertige Post-Agent-Konfiguration

Details dazu in Einheit 5.

3. Prüfen — ist das richtig?

Werkzeug	Beantwortet
towelscript_check	Ist die Syntax gültig?
towelscript_compile	Was wird daraus konkret — welche Agents mit welchen Optionen?
towelscript_graph	Wie sind die Nodes tatsächlich verbunden?
towelscript_symbols	Welche Module, Flows und Nodes enthält die Datei?
towelscript_format	Formatiert den Quelltext

Alle fünf arbeiten rein auf dem Text und fassen deine Instanz nicht an. Du kannst sie beliebig oft aufrufen, ohne dass etwas passiert. Details in Einheit 6.

Hinweis

towelscript_format gibt den Quelltext derzeit unverändert zurück — es normalisiert weder Einrückung noch Abstände. Verlass dich für einheitliche Formatierung nicht darauf, sondern auf eine Konvention im Team.

4. Bauen — mach es echt

Werkzeug	Bewirkt
workflow_deploy	Legt aus TowelScript einen neuen Workflow an
workflow_update	Bringt einen bestehenden Workflow auf den Stand des Quelltexts
agent_update	Ändert einen Agent gezielt, ohne den Rest anzufassen
workflow_duplicate	Kopiert einen Workflow inklusive Verbindungen
workflow_delete	Löscht einen Workflow und alle seine Agents — unwiderruflich

5. Ausführen und testen

Werkzeug	Bewirkt
agent_test_run	Dry-Run für einen Agent mit einer Beispiel-Payload
workflow_run	Löst den kompletten Workflow echt aus und liefert eine run_id
message_reemit	Schickt eine bereits existierende Nachricht erneut durch den Workflow

6. Debuggen

Werkzeug	Beantwortet
workflow_logs	Was ist im letzten Lauf über alle Agents hinweg passiert?
agent_logs	Warum ist genau dieser Agent gescheitert?
workflow_messages	Welche Payloads sind durch den Workflow geflossen?
agent_messages	Was hat dieser Agent konkret ausgegeben?

Die wichtigste Unterscheidung: liest oder schreibt?

Bevor du ein Werkzeug aufrufen lässt, solltest du wissen, in welche Spalte es gehört:

Ohne Nebenwirkung	Verändert etwas
project_list, workflow_list, workflow_show, workflow_export	workflow_deploy, workflow_update, agent_update
towelscript_check, _compile, _graph, _symbols, _format	workflow_duplicate, workflow_delete
agent_docs, credential_list, api_spec_*	workflow_run, message_reemit
workflow_logs, agent_logs, workflow_messages, agent_messages	agent_test_run (teilweise — siehe Einheit 7)

workflow_delete ist endgültig

Es gibt keinen Papierkorb. Der Workflow und alle seine Agents sind weg. Vor dem Löschen: workflow_export aufrufen und das JSON sichern.

Was fehlt

Damit du nicht danach suchst — diese Dinge kann die Schnittstelle nicht:

• Credentials anlegen oder ändern. credential_list liefert nur Namen. Werte legst du ausschließlich in der Oberfläche an.
• Benutzer verwalten. Keine Rollen, keine Berechtigungen, keine Kontoverwaltung.
• UI Apps bauen. Oberflächen (Modul 5) bleiben Sache des Designers.
• Canvas-Layout gestalten. agent_update kann zwar pos_x und pos_y setzen, aber automatisch angeordnet wird nichts — frisch deployte Workflows brauchen im Canvas meist einmal Handarbeit.
• Projekte anlegen. Es gibt nur project_list.

Zusammengefasst

Deine Frage	Werkzeug
Was habe ich überhaupt?	workflow_list, workflow_show
Welche Optionen kennt dieser Agent?	agent_docs
Ist mein Quelltext richtig?	towelscript_check + _compile + _graph
Funktioniert dieser eine Agent?	agent_test_run
Ab in die Instanz damit	workflow_deploy / workflow_update
Warum kommt nichts an?	workflow_logs, agent_messages
Nochmal mit denselben Daten	message_reemit

Weiter: Einheit 4 — TowelScript: die Sprache